Compile on Docker/pl

Other languages:
Kompilacja w systemie MacOS
Docker dla FreeCAD tryb CLI
Spis treści
Ta strona jest zachowana tylko dla celów archiwalnych, zobacz odpowiednią sekcję Podręcznika Dewelopera, aby uzyskać aktualne informacje.

Informacje ogólne

Wśród opcji kompilacji i instalacji FreeCAD istnieje możliwość użycia Dockera. Ta metoda jest przydatna przede wszystkim dla programistów FreeCAD korzystających z komputerów z systemem Linux lub macOS.

Korzyści

Wszystkie zależności FreeCAD są już zainstalowane, kompatybilne ze sobą i odpowiednio skonfigurowane, co pozwala na bardzo szybkie rozpoczęcie programowania.

Repozytorium Docker

Wymagania wstępne

Instalacja

Pobieranie źródła

Najlepszym sposobem na uzyskanie kodu źródłowego FreeCAD jest sklonowanie repozytorium Git. W tym celu potrzebny jest program git, który można łatwo zainstalować w większości dystrybucji systemów Linux i macOS, a także można go uzyskać z oficjalnej strony internetowej Git.

Poniższe polecenie umieści kopię najnowszej wersji kodu źródłowego programu FreeCAD w nowym katalogu o nazwie freecad-source. 

git clone --recurse-submodules https://github.com/FreeCAD/FreeCAD.git ~/my_code/freecad_source

Więcej informacji na temat używania środowiska Git i wnoszenia kodu do projektu można znaleźć na stronie Zarządzanie kodem źródłowym.

Utwórz katalog kompilacji

Utwórz katalog do przechowywania skompilowanego źródła FreeCAD. 

mkdir ~/my_code/freecad_build

Ściągnij obraz Docker

Ściągnij obraz Docker. (Oficjalny obraz wkrótce). 

docker pull registry.gitlab.com/daviddaish/freecad_docker_env:latest

Zezwól na dostęp do menedżera okien

Aby FreeCAD mógł uruchomić swój graficzny interfejs użytkownika z poziomu kontenera Docker, należy nadać Dockerowi uprawnienia dostępu do menedżera okien. W większości dystrybucji Linuksa jest to system okien X. Możesz użyć poniższego polecenia, aby zezwolić Dockerowi na dostęp do X, aż do ponownego uruchomienia lub wylogowania komputera. 

xhost +

Jeśli jesteś połączony z niezaufanymi systemami, na przykład przez ssh, sprawi to, że będziesz podatny na złośliwy kod. Zamknij wszystkie połączenia ssh lub sprawdź bezpieczniejsze uprawnienia xhost, co wykracza poza zakres tego samouczka.

Użytkownicy systemu MacOS

Dla tych, którzy używają macOS, system okien X może nie być zainstalowany. Projekt XQuartz to długo działający projekt open source, który pozwoli ci dodać go do twojego komputera. Można go znaleźć na stronie domowej.

Uruchomienie obrazu docker

Przypisz zmienne środowiskowe, aby kontener Docker zamontował kod źródłowy FreeCAD i katalog kompilacji. Ponadto możesz zamontować dodatkowy katalog zawierający dowolne pliki, których chcesz użyć do celów testowych. W poniższym fragmencie pozostawiliśmy go jako katalog domowy jako proste ustawienie domyślne. 

fc_source=~/my_code/freecad_source
fc_build=~/my_code/freecad_build
other_files=~/

Uruchom obraz Docker. 

docker run -it --rm \
-v $fc_source:/mnt/source \
-v $fc_build:/mnt/build \
-v $other_files:/mnt/files \
-e "DISPLAY" -e "QT_X11_NO_MITSHM=1" -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
registry.gitlab.com/daviddaish/freecad_docker_env:latest

Kompilacja FreeCAD

Możesz zbudować FreeCAD za pomocą zainstalowanego skryptu kompilacji lub przy użyciu preferowanej metody. 

/root/build_script.sh

Uruchomienie FreeCAD

Po zbudowaniu FreeCAD można go uruchomić w normalny sposób. 

/mnt/build/bin/FreeCAD

Dołączone katalogi można znaleźć w katalogu /mnt.

Dyskusja

Powiązane


Kompilacja w systemie MacOS
Docker dla FreeCAD tryb CLI
Spis treści
Centrum użytkownika